<?php
/**
 * 21cnjySDK
 * @author    Simon <150986416@qq.com>
 * @filename  Document.php
 * @created   2017/7/5 下午2:52
 */

namespace sdk\modules;

/**
 * 文档资源接口
 * Class Document
 * @see http://dev.21cnjy.com/docs/#api-Document
 * @package sdk\modules
 */
class Document extends Module
{
    /**
     * 获取资源列表
     * @param array $params 请求资源列表的请求参数，接口将会以请求参数作为过滤条件
     * ~~~~
     * $params = array (
     *  'stage' => '1', // 学段
     *  'subjectId' => '3',  // 学科
     *  'chapterId' => '23694',  // 章节
     *  'type' => NULL, 
     *  'flag' => NULL, 
     *  'stars' => NULL, 
     *  'provinceId' => NULL, 
     *  'page' => NULL, 
     *  'knowledgeId' => '4319', 
     *  'title' => NULL
     * )
     * ~~~~
     * @return bool|mixed
     */
    public function getItems(array $params)
    {
        return $this->client->httpGet('/api/v3/document/items', $params);
    }

    /**
     * 获取资源详情(下载信息)
     * @param string $itemIds 资源ID，多个以逗号隔开
     * @return bool|mixed
     */
    public function getItemDetails($itemIds)
    {
        return $this->client->httpGet('/api/v3/document/item-details', array(
            'itemIds' => $itemIds
        ));
    }

    /**
     * 获取指定资源的预览数据
     * @see http://dev.21cnjy.com/docs/#api-document-preview
     * @param int $itemId
     * @return bool|mixed
     */
    public function getPreview(int $itemId)
    {
        return $this->client->httpGet('/api/v3/document/preview', array(
            'itemId' => $itemId
        ));
    }
}